Перейти к основному содержимому
Версия: 2.0.0

Настройка backup Lighthouse

Скрипт: backup.sh

Целевая среда: Linux, Bash 4.4+, Docker Engine с Docker Compose v2.

Запуск​

# абсолютный или относительный путь к docker-compose.yml
./backup.sh backup /absolute/path/docker-compose.yml
./backup.sh restore /absolute/path/docker-compose.yml

Запускать от пользователя с доступом к Docker, правами записи в каталог Compose и каталог бэкапов.

Путь к каталогу бэкапов запрашивается интерактивно, при этом предлагается использовать каталог .backups по умолчанию.

Относительный путь отсчитывается от каталога Compose, который показывается в логе.

Для restore используется родительский каталог .backups, а также можно указать конкретный бэкап backup-* внутри директории с бэкапами. В родительском каталоге выбирается последний по имени завершенный backup-*. Выбранный бэкап показывается и подтверждается отдельно. Перед остановкой стека и перезаписью данных требуются точные фразы STOP и RESTORE.

Как это выглядит в консоли​

Backup​

./backup.sh backup docker-compose.yml
2026-09-21 06:47:35 [ИНФО] Версия скрипта: 2.0.0
2026-09-21 06:47:35 [ИНФО] Проверяю конфигурацию Compose...
2026-09-21 06:47:35 [ OK ] Compose-файл валиден: /home/gitlab-runner/builds/S-EByQJzJ/0/csp/devops/docker_compose_template/output/docker-compose.yml
2026-09-21 06:47:35 [ИНФО] Volumes, объявленные в Compose:
keeper -> keeper
pgdata -> pgdata
vault_file -> vault_file
vault_keys -> vault_keys
vault_logs -> vault_logs
vault_root -> vault_root
was-doc -> was-doc
# Во время работы скрипта используется Докер образ alpine:3.22, если нет доступа к Docker Hub можно переопределить переменную HELPER_IMAGE
2026-09-21 06:47:35 [ OK ] Вспомогательный образ найден: alpine:3.22
2026-09-21 06:47:35 [ИНФО] Относительный путь отсчитывается от: /home/gitlab-runner/builds/S-EByQJzJ/0/csp/devops/docker_compose_template/output
# Нужно указать каталог с бэкапами, по умолчанию это ".backups", т.е. скрытый каталог рядом с docker-compose.yml
# Достаточно нажать Enter для использования значения по умолчанию
Каталог с резервными копиями [.backups] (для восстановления можно указать конкретный backup-*):
2026-09-21 06:47:41 [ИНФО] Набор резервной копии: /home/gitlab-runner/builds/S-EByQJzJ/0/csp/devops/docker_compose_template/output/.backups/backup-2026-09-21_064741
2026-09-21 06:47:41 [ИНФО] Свободное место: 11G
2026-09-21 06:47:41 [ИНФО] Жду SQL-подключения к PostgreSQL (до 90 с)...
2026-09-21 06:47:42 [ OK ] PostgreSQL принимает SQL-запросы.
2026-09-21 06:47:42 [ПРЕД] На время резервного копирования запрещены развертывания, ручной запуск/перезапуск контейнеров и внешние записи в PostgreSQL/volumes.

Проект: lighthouse
Останется запущенным: db
Будут остановлены:
reflector
web-ui
asset-manager
was-go
exs-go
vault-init
keeper
vault
Приложение будет недоступно до завершения всех дампов и архивов.
# Нужно явно подтвердить остановку Lighthouse перед бэкапом
Для остановки и продолжения резервного копирования введите STOP: STOP
# Больше скрипт ничего не запрашивает
2026-09-21 06:47:59 [ИНФО] Останавливаю: reflector web-ui asset-manager was-go exs-go keeper
[+] Stopping 6/6
✔ Container lighthouse-web-ui-1 Stopped 0.4s
✔ Container lighthouse-exs-go-1 Stopped 0.4s
✔ Container lighthouse-reflector-1 Stopped 0.3s
✔ Container lighthouse-keeper-1 Stopped 0.2s
✔ Container lighthouse-asset-manager-1 Stopped 0.4s
✔ Container lighthouse-was-go-1 Stopped 0.3s
2026-09-21 06:48:00 [ OK ] 'reflector' остановлен.
2026-09-21 06:48:00 [ OK ] 'web-ui' остановлен.
2026-09-21 06:48:00 [ OK ] 'asset-manager' остановлен.
2026-09-21 06:48:00 [ OK ] 'was-go' остановлен.
2026-09-21 06:48:00 [ OK ] 'exs-go' остановлен.
2026-09-21 06:48:00 [ OK ] 'keeper' остановлен.
2026-09-21 06:48:00 [ИНФО] Останавливаю: vault-init
[+] Stopping 1/1
✔ Container lighthouse-vault-init-1 Stopped 5.0s
2026-09-21 06:48:05 [ OK ] 'vault-init' остановлен.
2026-09-21 06:48:05 [ИНФО] Останавливаю: vault
[+] Stopping 1/1
✔ Container lighthouse-vault-1 Stopped 0.6s
2026-09-21 06:48:06 [ OK ] 'vault' остановлен.
2026-09-21 06:48:06 [ OK ] Окно консистентного резервного копирования открыто: все контейнеры проекта остановлены, кроме db.
2026-09-21 06:48:07 [ИНФО] Жду SQL-подключения к PostgreSQL (до 90 с)...
2026-09-21 06:48:07 [ OK ] PostgreSQL принимает SQL-запросы.
2026-09-21 06:48:07 [ИНФО] Проверяю наличие БД 'river_go'...
2026-09-21 06:48:07 [ИНФО] Резервное копирование PostgreSQL: river_go -> river_go.dump.gz
2026-09-21 06:48:08 [ OK ] PostgreSQL 'river_go': 4.0K, дамп проверен.
2026-09-21 06:48:08 [ИНФО] Проверяю наличие БД 'was_go'...
2026-09-21 06:48:08 [ИНФО] Резервное копирование PostgreSQL: was_go -> was_go.dump.gz
2026-09-21 06:48:09 [ OK ] PostgreSQL 'was_go': 168K, дамп проверен.
2026-09-21 06:48:10 [ИНФО] Резервное копирование полного volume keeper 'keeper'...
2026-09-21 06:48:10 [ OK ] Volume keeper: 4.0K, архив tar проверен.
2026-09-21 06:48:10 [ИНФО] Резервное копирование volume 'vault_keys' (vault_keys)...
2026-09-21 06:48:11 [ OK ] vault_keys: 4.0K, архив tar проверен.
2026-09-21 06:48:11 [ИНФО] Резервное копирование volume 'vault_file' (vault_file)...
2026-09-21 06:48:11 [ OK ] vault_file: 40K, архив tar проверен.
2026-09-21 06:48:11 [ИНФО] Резервное копирование volume 'vault_root' (vault_root)...
2026-09-21 06:48:12 [ OK ] vault_root: 4.0K, архив tar проверен.
2026-09-21 06:48:13 [ OK ] Все дампы и архивы сохранены: /home/gitlab-runner/builds/S-EByQJzJ/0/csp/devops/docker_compose_template/output/.backups/backup-2026-09-21_064741
2026-09-21 06:48:13 [ИНФО] Возвращаю только контейнеры, которые работали до резервного копирования...
2026-09-21 06:48:13 [ИНФО] Жду SQL-подключения к PostgreSQL (до 90 с)...
2026-09-21 06:48:13 [ OK ] PostgreSQL принимает SQL-запросы.
2026-09-21 06:48:13 [ OK ] Команда запуска выполнена для: vault
2026-09-21 06:48:13 [ИНФО] Жду доступности API восстановленного Vault до 90 с; состояние sealed=true пока допустимо.
2026-09-21 06:48:13 [ OK ] API Vault доступен: initialized=true, sealed=true; можно запускать vault-init.
2026-09-21 06:48:13 [ИНФО] Жду доступности API восстановленного Vault до 90 с; состояние sealed=true пока допустимо.
2026-09-21 06:48:14 [ OK ] API Vault доступен: initialized=true, sealed=true; можно запускать vault-init.
2026-09-21 06:48:14 [ OK ] Команда запуска выполнена для: vault-init
2026-09-21 06:48:14 [ИНФО] Жду initialized=true и sealed=false (до 180 с, интервал 3 с)...
2026-09-21 06:48:15 [ OK ] Vault/OpenBao готов: initialized=true, sealed=false; прошло 1 с.
[+] Running 7/7
✔ Container lighthouse-db-1 Healthy1.5s
✔ Container lighthouse-keeper-1 Started0.2s
✔ Container lighthouse-exs-go-1 Started0.5s
✔ Container lighthouse-was-go-1 Healthy6.0s
✔ Container lighthouse-web-ui-1 Started0.4s
✔ Container lighthouse-asset-manager-1 Started0.4s
✔ Container lighthouse-reflector-1 Started0.4s
2026-09-21 06:48:23 [ OK ] Команда запуска выполнена для: reflector web-ui asset-manager was-go exs-go keeper
2026-09-21 06:48:23 [ИНФО] Проверяю сервисы до 180 с; требуется 15 с стабильного состояния.
2026-09-21 06:48:23 [ИНФО] Ожидаю reflector: состояние=running, health=starting, число_рестартов=0, код_выхода=0.
2026-09-21 06:48:23 [ИНФО] Ожидаю asset-manager: состояние=running, health=starting, число_рестартов=0, код_выхода=0.
2026-09-21 06:48:23 [ИНФО] Ожидаю keeper: состояние=restarting, health=unhealthy, число_рестартов=6, код_выхода=255.
2026-09-21 06:48:23 [ИНФО] Ожидаю vault-init: состояние=running, health=starting, число_рестартов=0, код_выхода=0.
2026-09-21 06:48:29 [ИНФО] Сервисы в допустимом состоянии; начинаю отсчет 15 с стабильности.
2026-09-21 06:48:46 [ OK ] Сервисы прошли проверку запуска и стабильности; прошло 23 с.
2026-09-21 06:48:46 [ OK ] Ранее работавшие сервисы запущены и проверены.
2026-09-21 06:48:46 [ OK ] Резервное копирование полностью завершено: /home/gitlab-runner/builds/S-EByQJzJ/0/csp/devops/docker_compose_template/output/.backups/backup-2026-09-21_064741
2026-09-21 06:48:46 [ИНФО] Размер набора резервной копии: 252K


# можно посмотреть что бэкап создался
ls -la .backups/backup-<дата>_<время>/

Restore​

./backup.sh restore docker-compose.yml
2026-09-21 06:52:59 [ИНФО] Версия скрипта: 2.0.0
2026-09-21 06:52:59 [ИНФО] Проверяю конфигурацию Compose...
2026-09-21 06:53:00 [ OK ] Compose-файл валиден: /home/gitlab-runner/builds/S-EByQJzJ/0/csp/devops/docker_compose_template/output/docker-compose.yml
2026-09-21 06:53:00 [ИНФО] Volumes, объявленные в Compose:
keeper -> keeper
pgdata -> pgdata
vault_file -> vault_file
vault_keys -> vault_keys
vault_logs -> vault_logs
vault_root -> vault_root
was-doc -> was-doc
2026-09-21 06:53:00 [ OK ] Вспомогательный образ найден: alpine:3.22
2026-09-21 06:53:00 [ИНФО] Относительный путь отсчитывается от: /home/gitlab-runner/builds/S-EByQJzJ/0/csp/devops/docker_compose_template/output
# Нужно указать каталог с бэкапами
# Достаточно нажать Enter для использования значения по умолчанию
Каталог с резервными копиями [.backups] (для восстановления можно указать конкретный backup-*):
2026-09-21 06:53:10 [ИНФО] Для восстановления выбран набор: /home/gitlab-runner/builds/S-EByQJzJ/0/csp/devops/docker_compose_template/output/.backups/backup-2026-09-21_064741
# Обязательное подтверждение, y или n в любом регистре (по умолчанию N, при нажатии на Enter)
Использовать именно его? [y/N]: y
2026-09-21 06:53:18 [ИНФО] Проверяю SHA256 всех восстанавливаемых файлов...
2026-09-21 06:53:18 [ OK ] SHA256: postgres/river_go.dump.gz
2026-09-21 06:53:18 [ OK ] SHA256: postgres/was_go.dump.gz
2026-09-21 06:53:18 [ OK ] SHA256: keeper/keeper-volume.tar.gz
2026-09-21 06:53:18 [ OK ] SHA256: vault/vault_keys.tar.gz
2026-09-21 06:53:18 [ OK ] SHA256: vault/vault_file.tar.gz
2026-09-21 06:53:18 [ OK ] SHA256: vault/vault_root.tar.gz
2026-09-21 06:53:18 [ OK ] SHA256 compose-файла совпадает. Это не проверка содержимого .env или образов.
2026-09-21 06:53:18 [ OK ] Набор резервной копии прошел проверку.

ВНИМАНИЕ
Будут остановлены сервисы текущего проекта Compose.
Будет УДАЛЕНО СОДЕРЖИМОЕ volumes:
keeper -> keeper
vault_keys -> vault_keys
vault_file -> vault_file
vault_root -> vault_root
Базы PostgreSQL будут DROP/CREATE и восстановлены из dump:
river_go
was_go
Источник восстановления: /home/gitlab-runner/builds/S-EByQJzJ/0/csp/devops/docker_compose_template/output/.backups/backup-2026-09-21_064741
Автоматического отката нет. Текущее состояние должно быть сохранено отдельной резервной копией.
# Обязательное подтверждение, нужно ввести слово "RESTORE"
Для продолжения введите RESTORE: RESTORE
2026-09-21 06:53:34 [ИНФО] Останавливаю стек Compose...
[+] Stopping 9/9
✔ Container lighthouse-vault-init-1 Stopped 4.9s
✔ Container lighthouse-web-ui-1 Stopped 0.4s
✔ Container lighthouse-reflector-1 Stopped 0.3s
✔ Container lighthouse-exs-go-1 Stopped 0.2s
✔ Container lighthouse-keeper-1 Stopped 0.2s
✔ Container lighthouse-asset-manager-1 Stopped 0.2s
✔ Container lighthouse-was-go-1 Stopped 0.2s
✔ Container lighthouse-db-1 Stopped 1.0s
✔ Container lighthouse-vault-1 Stopped 0.3s
2026-09-21 06:53:40 [ OK ] Стек Compose остановлен.
2026-09-21 06:53:40 [ИНФО] Создаю только отсутствующие контейнеры и volumes, без запуска и пересоздания существующих...
2026-09-21 06:53:41 [ OK ] Ресурсы Compose и фактические подключения volumes проверены.
2026-09-21 06:53:41 [ИНФО] Очищаю содержимое volume 'keeper'...
2026-09-21 06:53:41 [ИНФО] Распаковываю keeper-volume.tar.gz -> keeper
2026-09-21 06:53:42 [ OK ] Volume 'keeper' восстановлен.
2026-09-21 06:53:42 [ OK ] Volume keeper восстановлен.
2026-09-21 06:53:42 [ИНФО] Очищаю содержимое volume 'vault_keys'...
2026-09-21 06:53:42 [ИНФО] Распаковываю vault_keys.tar.gz -> vault_keys
2026-09-21 06:53:42 [ OK ] Volume 'vault_keys' восстановлен.
2026-09-21 06:53:42 [ИНФО] Очищаю содержимое volume 'vault_file'...
2026-09-21 06:53:43 [ИНФО] Распаковываю vault_file.tar.gz -> vault_file
2026-09-21 06:53:43 [ OK ] Volume 'vault_file' восстановлен.
2026-09-21 06:53:43 [ИНФО] Очищаю содержимое volume 'vault_root'...
2026-09-21 06:53:43 [ИНФО] Распаковываю vault_root.tar.gz -> vault_root
2026-09-21 06:53:44 [ OK ] Volume 'vault_root' восстановлен.
2026-09-21 06:53:44 [ OK ] Volumes Vault/OpenBao восстановлены.
2026-09-21 06:53:44 [ИНФО] Запускаю только PostgreSQL...
[+] Running 1/1
✔ Container lighthouse-db-1 Started 0.3s
2026-09-21 06:53:44 [ИНФО] Жду SQL-подключения к PostgreSQL (до 90 с)...
2026-09-21 06:53:44 [ OK ] PostgreSQL принимает SQL-запросы.
2026-09-21 06:53:45 [ИНФО] Пересоздаю базу PostgreSQL 'river_go'...
2026-09-21 06:53:46 [ИНФО] Восстановление PostgreSQL: river_go
2026-09-21 06:53:46 [ OK ] PostgreSQL 'river_go' восстановлен; пользовательских таблиц: 6.
2026-09-21 06:53:46 [ИНФО] Пересоздаю базу PostgreSQL 'was_go'...
2026-09-21 06:53:47 [ИНФО] Восстановление PostgreSQL: was_go
2026-09-21 06:53:53 [ OK ] PostgreSQL 'was_go' восстановлен; пользовательских таблиц: 117.
2026-09-21 06:53:53 [ OK ] Данные восстановлены. Перехожу к запуску и проверкам.
2026-09-21 06:53:53 [ИНФО] Запускаю Vault/OpenBao отдельно от приложений...
[+] Running 1/1
✔ Container lighthouse-vault-1 Started 0.2s
2026-09-21 06:53:54 [ИНФО] Жду доступности API восстановленного Vault до 90 с; состояние sealed=true пока допустимо.
2026-09-21 06:53:54 [ OK ] API Vault доступен: initialized=true, sealed=true; можно запускать vault-init.
[+] Running 1/1
✔ Container lighthouse-vault-init-1 Started 0.2s
2026-09-21 06:53:54 [ИНФО] Жду initialized=true и sealed=false (до 180 с, интервал 3 с)...
2026-09-21 06:53:55 [ OK ] Vault/OpenBao готов: initialized=true, sealed=false; прошло 1 с.
2026-09-21 06:53:55 [ИНФО] Запускаю стек Compose без пересоздания существующих контейнеров...
[+] Running 9/9
✔ Container lighthouse-vault-1 Running 0.0s
✔ Container lighthouse-vault-init-1 Running 0.0s
✔ Container lighthouse-db-1 Healthy 5.4s
✔ Container lighthouse-keeper-1 Started 0.2s
✔ Container lighthouse-exs-go-1 Started 0.5s
✔ Container lighthouse-was-go-1 Healthy 5.9s
✔ Container lighthouse-web-ui-1 Started 0.4s
✔ Container lighthouse-asset-manager-1 Started 0.2s
✔ Container lighthouse-reflector-1 Started 0.3s
2026-09-21 06:54:06 [ИНФО] Проверяю сервисы до 180 с; требуется 15 с стабильного состояния.
2026-09-21 06:54:06 [ИНФО] Ожидаю asset-manager: состояние=running, health=starting, число_рестартов=0, код_выхода=0.
2026-09-21 06:54:06 [ИНФО] Ожидаю keeper: состояние=restarting, health=unhealthy, число_рестартов=7, код_выхода=255.
2026-09-21 06:54:06 [ИНФО] Ожидаю reflector: состояние=running, health=starting, число_рестартов=0, код_выхода=0.
2026-09-21 06:54:16 [ИНФО] Сервисы в допустимом состоянии; начинаю отсчет 15 с стабильности.
2026-09-21 06:54:32 [ OK ] Сервисы прошли проверку запуска и стабильности; прошло 26 с.

NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
lighthouse-asset-manager-1 gitlab.ya:5050/csp/asset-manager:260914-0747-release-2-0-0 "./asset-manager" asset-manager 2 minutes ago Up 26 seconds (healthy) 0.0.0.0:8082->8082/tcp, [::]:8082->8082/tcp
lighthouse-db-1 gitlab.ya:5050/csp/devops/postgres:16.4 "sh -c '\n cp /tmp/s…" db 2 minutes ago Up 48 seconds (healthy) 0.0.0.0:5432->5432/tcp, [::]:5432->5432/tcp
lighthouse-exs-go-1 gitlab.ya:5050/csp/exs-go:260914-0648-release-2-0-0 "/app/exs-go serve" exs-go 2 minutes ago Up 32 seconds (healthy) 8089/tcp
lighthouse-keeper-1 gitlab.ya:5050/csp/module-manager:260914-0636-release-2-0-0 "./keeper" keeper 2 minutes ago Up 23 seconds (healthy)
lighthouse-reflector-1 gitlab.ya:5050/csp/reflector:260914-1125-release-2-0-0 "/docker-entrypoint.…" reflector 2 minutes ago Up 26 seconds (healthy) 0.0.0.0:8083->8083/tcp, [::]:8083->8083/tcp, 8088/tcp
lighthouse-vault-1 gitlab.ya:5050/csp/devops/openbao_with_curl:2.5.3 "/usr/local/bin/dock…" vault 2 minutes ago Up 38 seconds (healthy) 8200/tcp
lighthouse-vault-init-1 gitlab.ya:5050/csp/devops/vault-init:2.0.0 "/bin/sh /usr/local/…" vault-init 2 minutes ago Up 38 seconds (healthy)
lighthouse-was-go-1 gitlab.ya:5050/csp/was-go:260917-1229-release-2-0-0 "/app/was-go serve" was-go 2 minutes ago Up 32 seconds (healthy) 0.0.0.0:8089->8088/tcp, [::]:8089->8088/tcp
lighthouse-web-ui-1 gitlab.ya:5050/csp/web-ui:260915-1233-release-2-0-0 "/docker-entrypoint.…" web-ui 2 minutes ago Up 32 seconds (healthy) 0.0.0.0:80->80/tcp, [::]:80->80/tcp, 0.0.0.0:443->443/tcp, [::]:443->443/tcp

2026-09-21 06:54:32 [ OK ] Восстановление завершено; проверка запуска пройдена.
2026-09-21 06:54:32 [ИНФО] Рекомендуемые финальные проверки:
docker compose -f /home/gitlab-runner/builds/S-EByQJzJ/0/csp/devops/docker_compose_template/output/docker-compose.yml ps -a
docker compose -f /home/gitlab-runner/builds/S-EByQJzJ/0/csp/devops/docker_compose_template/output/docker-compose.yml logs --tail=200